home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / os2 / hv102.arj / README.DOC < prev    next >
Text File  |  1994-07-23  |  11KB  |  265 lines
  1.                               HyperView
  2.                              Version 1.02
  3.  
  4.  
  5.                  Copyright 1994 by Michael H. Shacter
  6.                          10309 Parkwood Drive
  7.                    Kensington, Maryland 20895-4041
  8.  
  9. HyperView is a file viewer with special capabilities for isolating and
  10. extracting information from word processing and text files.  It reads
  11. popular word processing formats, as well as ASCII text files.
  12. HyperView's most powerful feature lets you quickly focus on pertinent
  13. information, by creating a form of reverse hypertext.  Although
  14. endowed with unique, advanced features, HyperView is as simple to use
  15. as a traditional file viewer.
  16.  
  17. These are some of HyperView's features:
  18.  
  19.  ■ Creates reverse hypertext (a) automatically, from the search
  20.    dialog, and (b) manually, by pressing the space bar.
  21.  
  22.  ■ Loads files almost instantaneously.
  23.  
  24.  ■ Blazingly fast searches.
  25.  
  26.  ■ Automatically recognizes and reads popular word processing formats,
  27.    including:  Amì Pro, DeScribe (versions 2 through 4.1), Microsoft
  28.    Word for Windows (versions 1.x, 2.0, and 6.0) and WordPerfect
  29.    (versions 5.x and 6.0).
  30.  
  31.  ■ Takes full advantage of the 32-bit OS/2 operating system.
  32.  
  33.  ■ Directory listing to pick file for viewing and to navigate file
  34.    system.
  35.  
  36.  ■ Adjustable right margin for stripped ASCII and word processing
  37.    files.
  38.  
  39.  ■ Searches may cross line boundaries when working with word
  40.    processing and stripped ASCII files.
  41.  
  42.  ■ Marked lines may be saved to a file for later reference.
  43.  
  44.  ■ All or part of a file may be gathered and saved.
  45.  
  46.  ■ May be started from the OS/2 DOS command line or a DOS program
  47.    running in an OS/2 DOS session (VDM).
  48.  
  49.  ■ Supports long file names on HPFS drives.
  50.  
  51.  ■ Case insensitive searches may be performed in any language.
  52.  
  53.  ■ Commands may be invoked without the use of shifted keystrokes.
  54.  
  55. This README file contains a brief description of HyperView.  It should
  56. be sufficient for most reasonably proficient computer users.  The
  57. accompanying User Reference Guide (HV.DOC) presents a complete
  58. explanation of all HyperView features and their usage.  HyperView
  59. offers some unique features for managing textual information.
  60. Consequently, regardless of your proficiency level, time spent
  61. perusing the manual may still prove rewarding.
  62.  
  63. HyperView is user supported software.  It is not free.  Information
  64. concerning registration and licensing of HyperView may be found at the
  65. end of the User Reference Guide in the section entitled
  66. "REGISTRATION".  In brief, there is a $35 fee to register HyperView.
  67. For business use, each person using HyperView at a site must be
  68. registered.  Volume discounts are available.
  69.  
  70.  
  71.                             [Installation]
  72.  
  73. The following files are included in the HyperView package:
  74.  
  75.  HV.EXE                       HyperView program
  76.  HV.ICO                       HyperView icon
  77.  HV.DOC                       User Reference Guide
  78.  README.DOC                   This file
  79.  REGISTER.FRM                 Registration form
  80.  WHATS.NEW                    List of enhancements
  81.  FILE_ID.DIZ                  BBS description
  82.  
  83. There are no special requirements for installing HyperView.  Simply
  84. copy HV.EXE and HV.ICO to a convenient directory.  You will probably
  85. find it most practical to place HyperView in a directory on your path.
  86.  
  87. You may also wish to create a HyperView object on your desktop.
  88.  
  89.  
  90.                          [Starting Hyperview]
  91.  
  92. The easiest way to start HyperView is from the Workplace Shell.  Drag
  93. the icon of a file you wish to view and drop it on the HyperView icon.
  94.  
  95. You may also start HyperView from any OS/2 command prompt.  The full
  96. syntax for starting HyperView is:
  97.  
  98.      HV [options] [filespec]
  99.  
  100. Filespec refers either to (1) a file name, in which case HyperView
  101. will load the file at startup, or (2) a path, in which case HyperView
  102. will display a directory of files in the designated directory at
  103. startup.  The path may be further limited by supplying a file mask.
  104. For example, the path "C:\DeScribe\Data" would result in a directory
  105. list of all files (*.*) in the C:\DeScribe\Data directory.
  106. Alternatively, the path "C:\DeScribe\Data\*.doc" would result in a
  107. directory list of all files with the .DOC extension (*.doc) in the
  108. C:\DeScribe\Data directory.  HyperView recognizes HPFS long file
  109. names.
  110.  
  111. There is no need to place quotes around long file names with embedded
  112. spaces.  If you do use quotes (through force of habit) place them
  113. around the entire file specification--not just the file name.
  114.  
  115. If a filespec is omitted at startup, HyperView will begin with a
  116. display of the current directory.  If HyperView cannot locate the file
  117. specified on the command line, rather than give a "file not found
  118. message", it will display a listing of the directory in which the file
  119. should be located.
  120.  
  121. From the directory listing you may select a file to view or navigate
  122. through your files.  For more information on using this feature,
  123. please see the section entitled "Files".
  124.  
  125.  
  126.                         [Command Line Options]
  127.  
  128. For your convenience, the following options are available when
  129. starting HyperView.  Notice that each option consists of a slash ("/")
  130. followed by a letter.  The letter may be upper- or lower-case.  All
  131. options must precede the filespec on the command line.
  132.  
  133. /F   Start HyperView in a full screen OS/2 session
  134. /W   Start HyperView in a windowed OS/2 session
  135. /M   Force HyperView to use monochrome
  136. /C   Force HyperView to use color (when it mistakenly
  137.      thinks you have a monochrome monitor)
  138. /A   Use alternative color scheme
  139. /R   Raw (do not convert word processing files)
  140. /Lnn Lines of text, where "nn" is a number from between 25 and 60.
  141.  
  142. If the /L command option is not employed, HyperView will automatically
  143. adjust to the number of rows on your display, which may be any value
  144. from 25 to 60.
  145.  
  146. HyperView may also be used with any program that allows the
  147. designation of an external file viewer.
  148.  
  149.  
  150.                [Starting Hyperview From a DOS session]
  151.  
  152. HyperView may also be started from an OS/2 DOS session (i.e. from a
  153. VDM).  The same syntax is used to start HyperView from a VDM as from
  154. the OS/2 command line.  When started from a VDM, HyperView will
  155. default to OS/2 full screen display mode.  If you prefer to start
  156. HyperView in an OS/2 window, add the "/W" option to the command line.
  157.  
  158.  
  159.                           [Using Hyperview]
  160.  
  161. Although HyperView offers advanced features, it utilizes a
  162. conventional user interface, requiring little, if no, effort to learn.
  163. In deference to those who have difficulty managing shifted keystrokes,
  164. virtually all HyperView commands can be accessed without using shifted
  165. keystrokes.
  166.  
  167. HyperView displays in one of three views.  In full screen view, all
  168. lines of text are displayed.  Marked line are differentiated with a
  169. distinctive color.  Condensed view is restricted to lines that have
  170. been marked.  In split screen view, marked lines are displayed in the
  171. upper screen.  The lower screen shows in context whichever line is
  172. highlighted in the upper screen.  The latter two views (condensed and
  173. split screen) are only  available when one or more lines have been
  174. marked.
  175.  
  176. Lines may be marked either (1) automatically with the search and mark
  177. feature of the Search Dialog or (2) manually  with the space bar.
  178. Once a line is marked, it remains marked until unmarked with the Clear
  179. Marks command or with the space bar.  Available command options depend
  180. on the active view and are summarized below.  Letter commands may be
  181. either upper- or lower-case.
  182.  
  183. The following commands are available in Full Screen view:
  184.  
  185.   Key                         Function
  186.  
  187.   S                           Search          )
  188.   F                           Forward Search  ) Search Dialog
  189.   B                           Back Search     )
  190.   +                           Repeat search forward
  191.   -                           Repeat search back
  192.   J                           Jump to line number
  193.   G                           Gather text
  194.   R                           Right margin setting
  195.   <Space>                     Mark/Unmark line
  196.   <Enter> or <F10>            Switch to Condensed view
  197.   <Ctrl-Enter> or <F9>        Switch to Split Screen view
  198.   <Esc>                       Exit program (with confirmation)
  199.  
  200. The following commands are available in Condensed and Split Screen
  201.  
  202.   <Space>                     Unmark Line
  203.   <Enter> or <Esc>            Switch to Full Screen
  204.  
  205. The following commands are available in all views
  206.  
  207.   <F1>                        Help
  208.   C                           Clear all marked lines
  209.   L                           List all marked lines to a file
  210.   N                           New file
  211.   T                           Tab expansion toggle
  212.   <F5>                        Files
  213.   <F10>                       Switch to Condensed view
  214.   <Ctrl-Enter> or <F9>        Switch to Split Screen view
  215.   <AltF4>                     Exit program (no confirmation)
  216.   <AltX>                      Exit program (no confirmation
  217.                                and clear screen)
  218.  
  219. Cursor Movement
  220.   Cursor Up                   <Up>
  221.   Cursor Down                 <Down>
  222.   Screen Up                   <PgUp>
  223.   Screen Down                 <PgDn>
  224.   Top of File                 <Home>
  225.   End of File                 <End>
  226.   Screen Left                 <Left>
  227.   Screen Right                <Right>
  228.  
  229.  
  230. Where appropriate, HyperView utilizes dialogs to solicit user input.
  231. The dialogs operate in the conventional manner.  Their usage is
  232. detailed in the User Reference Guide.
  233.  
  234.  
  235.                                [Files]
  236.  
  237. The Files directory listing looks and performs like other directory
  238. listing tools you may have used.  It appears automatically if no file
  239. is specified at startup.  The directory listing may be invoked later
  240. in a HyperView session by pressing F5.
  241.  
  242. When you press F5, the Files dialog prompts you for a filespec.  The
  243. initial filespec will be for all files (*.*) in the current directory
  244. on the current drive.  The filespec may be changed by editing the
  245. current filespec or by typing a new one.  As explained in the manual,
  246. it is not necessary to enter a full filespec.  HyperView makes
  247. assumptions about any missing information.
  248.  
  249. HyperView will remember any changes you make to the mask component of
  250. the filespec.  Thus, if you change the mask to "*.doc", HyperView will
  251. remember the change each time you change a directory from the Files
  252. directory listing or call the Files dialog.  To change the mask again,
  253. or to revert back to "*.*", edit the mask appropriately or simply type
  254. the new mask by itself.  The file mask is limited to 30 characters.
  255. Any excess characters will be truncated.
  256.  
  257. To load a file, position the cursor on the file name and press Enter.
  258. A file may also be loaded in a new HyperView session by pressing
  259. Ctrl-Enter (or F9).  To change to a new directory, position the cursor
  260. bar on the appropriate directory name (or on the parent) and press
  261. Enter.  To change to a new drive, press Ctrl and the key of the drive
  262. (i.e. Ctrl-A, for drive A:, Ctrl-C, for drive C:, etc.).  Pressing the
  263. first letter of a directory or file name will advance the cursor bar
  264. to the next entry beginning with that letter.
  265.